LSERVOPTS and Command-line Options

By default, the license file is named lservrc and it is placed in the same directory in which the License Manager resides. It may contain multiple license codes. Usually, the Sentinel RMS utilities (lslic, WlmAdmin and lsmon) are used to install the license code in the license file.

Here are few recommended settings for the license file:

1. For non-redundant License Managers, the default name of the license file is lservrc. For redundant License Managers, the redundant license should be added in the lservrlf file. A redundant License Manager can service both redundant and non-redundant license codes, if both types of license files are available to the License Manager.

1. The License Manager must have read/write access to the license file when the license installation program is being executed. If you are having a problem installing license codes, then you should verify that the License Manager has read/write access to the license file.

• If the License Manager cannot find the license file and error tracing is enabled, it will log the errors in the trace file.

Specifies the name and location of the optional license configuration file. The license configuration file can contain the following:

1. Remap statements for readable license strings If you have used remap statements for generating readable license codes, you need to ship them to your customers with the License Manager and the lsdecode utility (only if you send lsdecode to your customers).
2. Alert specifications for a license code The system administrator can optionally invoke alerts using a script or an e-mail under certain scenarios.

By default, the License Manager will look for the configuration file in the License Manager local directory. Alternatively, the location of the configuration file can also be provided by the environment variable, LSERVRCCNF or via the -e option.

The License Manager appends the .cnf extension to the license configuration file path and filename and searches for license-file-name.cnf.

See also: Alert Specifications.

Enables usage logging with the name and location of the License Manager’s usage log file. The usage log can give you a very good idea of how much each application is being used.

By default, usage logging is disabled. Else, it can also be enabled by using the -l option.

Usage logging automatically gets enabled on license addition for RMS version 7 and later licenses.

The default name and location for the usage log file on Windows is:

• On Windows 32-bit - <OSdrive>:\Windows\System32\lservsta
• On Windows 64-bit - <OSdrive>:\Windows\SysWOW64\lservsta

Do not specify .xml as the extension name of the usage log file. If done, the License Manager will not start.

Specifies the name and location of the trace file. By default, trace logging is disabled.

Sets the tracing level defined here.

The maximum size of the usage and trace file log (if enabled). The size can be specified in bytes,kilobytes, or megabytes. For instance, -z 2000 means 2000 bytes, -z 2k means 2 kilobytes, -z 2m means 2 megabytes. The default value is 50,00000 bytes (approximately 4.76MB).

Disables automatic backup of the usage and trace log files in case of overflow. The License Manager will stop writing further records to the file.

By default, when the log file reaches its maximum size the contents of the log file are moved into a new file that has the same name as the original log file but has two numeric digits appended to its name. For example, if the original log file is named lserv.log, the first backup file will be named lserv.log.00. The next time a backup file is created, the new file will use the next available backup number (for example, lserv.log.01). The maximum number of backup files is 99, beyond which the existing files will be overwritten sequentially.

If clients are connected to the License Manager when the backup file is created, dummy records are created for any pending transactions in the backup file; corresponding dummy records are created in the new file. When the License Manager is not started with the extended log option (described above), LM_SERVER appears in the user name. However, if that option is used, the actual user name appears in the user name field of each dummy record. As a result, the dummy entries are differentiated from rest of the entries by specific transaction IDs (13 and 15).

If the -x option is specified, the file will not be backed up on overflow.  

The License Manager port number 5093 is used by the TCP/IP protocol when transferring data between the License Manager and the client. If that port is in use, any other port can be set using the -port startup option.

Commuter licensing uses the same license tokens as other network licenses. To ensure that not all license tokens are used up by commuters, set the -com option to the percentage of license tokens you want to be used for commuter licensing. Once that percentage of tokens are used by commuter licenses, no more will be made available to commuters until tokens are returned.

Starts the License Manager as a redundant License Manager using the specified redundant license file. The file, lservrlf, is created using the rlftool or WRlfTool utilities (or by using WlmAdmin to call WRlfTool) to define the redundant License Manager pool. By default, the License Manager’s local directory is searched for the lservrlf file to start the License Manager as a redundant License Manager.

You do not need to use this option to start the License Manager as a redundant License Manager if a lservrlf redundant license file is in the same directory as the License Manager.

Specifies the level of encryption with which license transactions will be written to the license server log file, 1 to 4. For a discussion of why you might want to encrypt transactions and for information on the different levels, see Setting Usage Logging.

Your vendor can override your encryption level choice for specific license codes.

Specifies the name and location of the optional group reservations file.

The group reservation feature helps you restrict the use of the licensed application to particular users, groups, or computers. A group reservation file lsreserv is generated using the WlsGrMgr utility. It contains information about how many license tokens are reserved for members of different groups.

By default, the License Manager uses the lsreserv file in the current directory.

Use this option to specify upgrade license file.

If the base licenses lservrc is installed in the same directory in which the License Manager resides, then the upgrade license file ulservrc must reside in the same directory.

If the base license is installed at a custom location (using the -s option or LSERVRC environment variable), then the upgrade license location can be configured using the -us option or ULSERVRC environment variable.

Quiet mode. When this option is specified, the License Manager will start up quietly without displaying its banner. Unexpected conditions will still be logged as usual. (UNIX only.)

Allows anonymous logging in usage log files. As a result, real information for the following entries is shown anonymously in the usage log line:

• User name
• Host name
• Any comments inserted by the vendor

Correspondingly, an XML file is generated along with the usage log file. The XML file maps the anonymous details with the real ones. It would be kept at the same path and will have the same name as the usage log file and .xml extension. The format of the XML file is as follows:

<?xml version="1.0" encoding="UTF-8"?>
<map Product="Sentinel RMS License Manager v8.5.3.0000"XmlCreationTime="Thu Sep 10 20:02:30 2012">
  <mapRecord Original="hostName1" Anonymous ="ABCDE123456"/>
  <mapRecord Original="hostName2" Anonymous ="ABCDE123457"/>
  <mapRecord Original="user1" Anonymous ="ABCDE123458"/>
  <mapRecord Original="user2" Anonymous ="ABCDE123459"/>
  <mapRecord Original="logComment" Anonymous ="ABCDE123450"/>
</map>

Where,

• Product is the RMS License Manager and its version.
• XmlCreationTime – The time when the map file was originally created. This time will not change even when the License Manager is restarted.
• mapRecord – Each line containing a unique mapping of original to anonymous details. Any new entries are added into the same file.